大盤解析列表

⚠️ 建議優先使用新介面：新大盤分析列表，signal 使用國際通用交易術語（LONG/SHORT/SIDEWAYS），並新增 h24Summary、verdict 等欄位。

介面描述

透過代幣（BTC/ETH/SOL）查詢 AI 大盤解析的歷史記錄，支援時間範圍過濾。

使用情境：

適用於按代幣 ID 精確查詢歷史大盤分析記錄
適用於圖表渲染等批量取得情境
適用於了解特定代幣的 AI 綜合訊號與壓力支撐結論

資料更新頻率：每 5 分鐘更新一次

signal 表示當前 5 分鐘分析週期得出的方向。每個週期都直接返回 BUY、SELL 或 HOLD；若方向與上一週期相同，仍返回相同的基礎列舉值，不使用 BUY_CONTINUE、SELL_CONTINUE 或 HOLD_CONTINUE。

請求 URL

方法：POST
路徑：/open/v1/ai/getMarketAnalysisList

點數消耗

消耗點數：2

前置條件

需要 vsTokenId，可透過代幣列表介面取得。

請求參數

參數透過請求體（Body）以 JSON 格式傳遞。

參數名	類型	必需	描述
vsTokenId	long	是	代幣 ID
beginTime	string	否	開始時間（毫秒時間戳）
endTime	string	否	結束時間（毫秒時間戳），不傳預設當前時間
limit	integer	否	回傳筆數，預設 200，範圍 1-2000
language	string	否	語言，支援 `zh-CN` / `zh-TW` / `en-US` / `vi-VN` / `ja-JP` / `ko-KR`，預設 `zh-CN`

回應欄位

僅展示 data 陣列內每個物件的欄位結構：

欄位	類型	實際回傳類型	描述
vsTokenId	long	string	代幣 ID
symbol	string	string	代幣符號
icon	string	string	代幣圖標 URL
price	number	string	分析時價格
signal	string	string	當前 5 分鐘分析週期的 AI 綜合訊號：`BUY`（利多）/ `SELL`（利空）/ `HOLD`（震盪）
klineDiff	number	string	K 線漲跌幅（小數，如 `-0.003` 表示 `-0.3%`）
supports	array	array<string>	支撐位價格列表（價格字元串）
resistances	array	array<string>	壓力位價格列表（價格字元串）
analysis	string	string	AI 分析結論（請求語言版本）
analysisTime	long	long	分析時間（毫秒時間戳）
verdict	integer	integer	訊號驗證結果：`0`=待驗證，`1`=相符，`2`=不符合
verdictDesc	string	string	訊號驗證結果描述
h24Summary	object	object	該分析時點的日內訊號分佈匯總（按本條 analysisTime 計算）
buyCount	integer	integer	利多次數
sellCount	integer	integer	利空次數
holdCount	integer	integer	震盪次數
total	integer	integer	總計次數
buyRatio	number	number	利多佔比（%，保留 1 位小數）
sellRatio	number	number	利空佔比（%，保留 1 位小數）
holdRatio	number	number	震盪佔比（%，保留 1 位小數）
conclusion	string	string	日內綜合結論：`OSCILLATE`（震盪）/ `OSCILLATE_BULLISH`（震盪偏多）/ `OSCILLATE_BEARISH`（震盪偏空）/ `BULLISH`（利多行情）/ `BEARISH`（利空行情）

欄位業務含義

欄位	業務含義	使用建議
vsTokenId	代幣唯一識別	與請求參數對應，用於資料歸屬驗證
symbol	代幣交易符號（如 BTC、ETH）	用於 UI 展示
icon	代幣圖標 URL	用於前端渲染
price	本條分析發布時的代幣價格	與 analysis 配合理解價格背景
signal	當前 5 分鐘分析週期的 AI 綜合方向訊號：`BUY`（利多）/ `SELL`（利空）/ `HOLD`（震盪）；方向延續時仍返回對應基礎值	快速判斷 AI 整體傾向
klineDiff	K 線變動幅度（小數，正值為漲，負值為跌）	與 signal 配合判斷價格動能
supports	AI 計算出的關鍵支撐價格列表	關注最近支撐位，輔助止損
resistances	AI 計算出的關鍵壓力價格列表	關注最近壓力位，輔助止盈
analysis	按請求語言回傳的 AI 綜合分析結論（string）	直接展示給使用者，無需客戶端再做語言分支處理
analysisTime	分析記錄的時間戳	用於按時間排序和展示
verdict	AI 訊號與實際走勢的驗證結果：`0`（待驗證）/ `1`（相符）/ `2`（不符合）	評估 AI 訊號的歷史準確率
verdictDesc	訊號驗證結果的文字描述	輔助理解驗證結論
h24Summary	以本條 analysisTime 為時點回看的日內訊號分佈匯總	統計窗口內利多/利空/震盪的次數與佔比，結合 conclusion 判斷日內整體行情傾向

請求範例

json

{
    "vsTokenId": 1,                 // 代幣 ID
    "beginTime": "1775732440000",   // 開始時間
    "endTime": "1775734240000",     // 結束時間
    "limit": 200,                   // 回傳筆數
    "language": "zh-CN"             // 語言（可選，預設 zh-CN）
}

cURL 範例（Linux/macOS）

bash

curl --location --request POST 'http://${host}/api/open/v1/ai/getMarketAnalysisList' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: xxxxx' \
--header 'X-TIMESTAMP: xxxxx' \
--header 'X-SIGN: xxxxx' \
--header 'Accept: */*' \
--data-raw '{
    "vsTokenId": 1,
    "beginTime": "1775732440000",
    "endTime": "1775734240000",
    "limit": 200,
    "language": "zh-CN"
}'

cURL 範例（Windows CMD）

cmd

curl --location --request POST "http://${host}/api/open/v1/ai/getMarketAnalysisList" ^
--header "Content-Type: application/json" ^
--header "X-API-KEY: xxxxx" ^
--header "X-TIMESTAMP: xxxxx" ^
--header "X-SIGN: xxxxx" ^
--header "Accept: */*" ^
--data-raw "{    \"vsTokenId\": 1,    \"beginTime\": \"1775732440000\",    \"endTime\": \"1775734240000\",    \"limit\": 200,    \"language\": \"zh-CN\"}"

成功回應範例

json

{
    "code": 200,
    "message": "success",
    "data": [
        {
            "vsTokenId": "1",                                            // 代幣 ID
            "symbol": "BTC",                                             // 代幣符號
            "icon": "https://static.valuescan.io/valuescan/cmc/coins/1.png", // 代幣圖標 URL
            "price": "80573.75",                                         // 分析時價格
            "signal": "HOLD",                                            // 當前 5 分鐘分析週期的 AI 綜合訊號：BUY（利多）/ SELL（利空）/ HOLD（震盪）
            "klineDiff": "-0.00298373",                                  // K 線漲跌幅（小數）
            "supports": ["80434.275", "79980.475"],                      // 支撐位價格列表
            "resistances": ["80776.78", "81208.86"],                     // 壓力位價格列表
            "analysis": "📊 BTC 日内主力资金趋势分析(ValueScan)...",     // AI 分析結論（當前語言版本）
            "analysisTime": 1778837430000,                               // 分析時間
            "verdict": 0,                                                // 訊號驗證結果：0=待驗證
            "verdictDesc": "待驗證",                                     // 訊號驗證結果描述
            "h24Summary": {                                              // 該分析時點的日內訊號分佈匯總
                "buyCount": 12,                                          // 利多次數
                "sellCount": 5,                                          // 利空次數
                "holdCount": 7,                                          // 震盪次數
                "total": 24,                                             // 總計次數
                "buyRatio": 50.0,                                        // 利多佔比（%）
                "sellRatio": 20.8,                                       // 利空佔比（%）
                "holdRatio": 29.2,                                       // 震盪佔比（%）
                "conclusion": "OSCILLATE_BULLISH"                        // 日內綜合結論：震盪偏多
            }
        }
    ],
    "requestId": "2055219406232641536"
}

大盤解析列表 ​

介面描述 ​

請求 URL ​

點數消耗 ​

前置條件 ​

請求參數 ​

回應欄位 ​

欄位業務含義 ​

請求範例 ​

cURL 範例（Linux/macOS） ​

cURL 範例（Windows CMD） ​

成功回應範例 ​

大盤解析列表

介面描述

請求 URL

點數消耗

前置條件

請求參數

回應欄位

欄位業務含義

請求範例

cURL 範例（Linux/macOS）

cURL 範例（Windows CMD）

成功回應範例